<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
    <head>
        <title>CruiseControl.NET : Iteration Labeller</title>
	    <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">	    
    </head>

    <body>
	    <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
		    <tr>
			    <td valign="top" class="pagebody">
				    <div class="pageheader">
					    <span class="pagetitle">
                            CruiseControl.NET : Iteration Labeller
                                                    </span>
				    </div>
				    <div class="pagesubheading">
					    This page last changed on Jul 01, 2009 by <font color="#0050B2">csut017</font>.
				    </div>

				    <h3><a name="IterationLabeller-IterationLabeller"></a>Iteration Labeller</h3>

<p>The Iteration Labeller is similar to the <a href="Default Labeller.html" title="Default Labeller">Default Labeller</a>; however, it maintains a revision number that is incremented by one for each iteration from the release start date.  For example, if the release start date was June 1, 2005 and the iteration duration was 2 weeks, the iteration number on July 1, 2005 would be 3.  This would create a label of &lt;prefix&gt;.3.&lt;build number&gt;.</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;project&gt;</span>
   <span class="code-tag">&lt;labeller type=<span class="code-quote">"iterationlabeller"</span>&gt;</span>
     <span class="code-tag">&lt;prefix&gt;</span>1.2<span class="code-tag">&lt;/prefix&gt;</span>
     <span class="code-tag">&lt;duration&gt;</span>1<span class="code-tag">&lt;/duration&gt;</span>
     <span class="code-tag">&lt;releaseStartDate&gt;</span>2005/6/24<span class="code-tag">&lt;/releaseStartDate&gt;</span>
     <span class="code-tag">&lt;separator&gt;</span>_<span class="code-tag">&lt;/separator&gt;</span>
   <span class="code-tag">&lt;/labeller&gt;</span>	
   <span class="code-tag"><span class="code-comment">&lt;!-- Other project configuration to go here --&gt;</span></span>
<span class="code-tag">&lt;/project&gt;</span></pre>
</div></div>

<h3><a name="IterationLabeller-ConfigurationElements%3A"></a>Configuration Elements:</h3>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Node </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Required</th>
<th class='confluenceTh'> Default </th>
<th class='confluenceTh'> Version </th>
</tr>
<tr>
<td class='confluenceTd'> prefix </td>
<td class='confluenceTd'> Any string to be put in front of all labels </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> "" </td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> duration </td>
<td class='confluenceTd'> The duration of the iteration in weeks </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> 2 </td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> releaseStartDate </td>
<td class='confluenceTd'> The start date for the release (the start date of iteration one) </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> true </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> separator </td>
<td class='confluenceTd'> The separator between the iteration number and the build number </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> . </td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> incrementOnFailure </td>
<td class='confluenceTd'> If true, the label will be incremented even if the build fails.  Otherwise it will only be incremented if the build succeeds. (Added in CCNet 1.1) </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> dynamicValues </td>
<td class='confluenceTd'> Any dynamic parameters to be used. See <a href="Dynamic Parameters.html" title="Dynamic Parameters">Dynamic Parameters</a> </td>
<td class='confluenceTd'> Dynamic values array - see <a href="Dynamic Parameters.html" title="Dynamic Parameters">Dynamic Parameters</a> </td>
<td class='confluenceTd'> No </td>
<td class='confluenceTd'> <em>None</em> </td>
<td class='confluenceTd'> 1.5.0 </td>
</tr>
</tbody></table>

<p>Contributed by Craig Campbell</p>

				    
                    			    </td>
		    </tr>
	    </table>
	    <table border="0" cellpadding="0" cellspacing="0" width="100%">
			<tr>
				<td height="12" background="http://confluence.public.thoughtworks.org//images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
			</tr>
		    <tr>
			    <td align="center"><font color="grey">Document generated by Confluence on Sep 29, 2009 20:59</font></td>
		    </tr>
	    </table>
    </body>
</html>